VSE/Advanced Functions 
Diagnosis Reference 


Linkage Editor 


VSE/Advanced Functions 
Diagnosis Reference 


Linkage Editor 


Program Number 5666-301 


Order Number LY33-9112-0 
File No. $370/4300-31 


First Edition (March 1985) 


This edition applies to Version 2 Release 1 of VSE/Advanced 
Functions, Program Number 5666-301 and to all subsequent 
releases until otherwise indicated in new editions or Technical 
Newsletters. Changes are made periodically to the information 
herein; before using this publication in connection with the 
operation of IBM systems, consult the latest IBM System/370, 


30XX_ and 4300 Processors Bibliography, GC20-0001, for the 
editions that are applicable and current. 


References in this publication to IBM products, programs, or 
services do not imply that IBM intends to make these available 
in all countries in which IBM operates. Any reference to an IBM 
program product in this document is not intended to state or 
imply that only IBM's program product may be used. Any 
functionally equivalent program may be used instead. 


Publications are not stocked at the addresses given below; 
requests for copies of IBM publications should be made to your 
IBM representative or to the IBM branch office serving your 
locality. 


A form for readers’ comments is provided at the back of this 
publication. If the form has been removed, comments may be 
addressed either to: 


IBM Corporation 

Dept. 6R1 

180 Kost Road 

Mechanicsburg, PA 17055, USA 


or to: 


IBM Deutschland GmbH 

Dept. 3248 

Schoenaicher Strasse 220 

D-7030 Boeblingen, Federal Republic of Germany 


IBM may use or distribute whatever information you supply in any 
way it believes appropriate without incurring any obligation to 


you. 


© Copyright International Business Machines Corporation 1985 


Cc 


PREFACE 


This Diagnosis Reference documents the code of the linkage editor 
component of VSE/Advanced Functions for the task of program service. 


The manual consists of the following chapters: 


: INTRODUCTION to the linkage editor, showing the context of the 
component in the system, the input and output of the program, 
and the different ways of calling it. 


. DESIGN INFORMATION, describing the function, I/0 flow, storage 
layout, and division into CSECTs and modules of the program. A 
description of the linkage editor phase gives all relevant 
information from the prologue of the listing. A detailed 


description shows the sequence of operations for each CSECT with 
the essential labels. 


° ORGANIZATION INFORMATION, listing the flow of control between 
the CSECTs of the program. 


° DATA AREAS, describing the formats of library records used by 
the program, linkage editor tables, and the librarian areas used 


by the linkage editor. 


e DIAGNOSTICS which contains interface information and cross ref- 
erences. 


An index at the end of the manual will help to find details fast. 


The text refers to the following IBM manuals: 


° VSE/Advanced Functions System Control Statements, SC33-6198 
e VSE/Advanced Functions Service Aids, SC33-6195 
° VSE/Advanced Functions Diagnosis Reference: Librarian, LY33-9111 


Titles and abstracts of other related publications are listed in 


System/370, 30xx and 4300 Processors Bibliography, GC20-0001. 
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C SUMMARY OF AMENDMENTS 


Version 2 Release 1 has the following technical improvements that 
are documented in this manual: 


e Changes due to the new librarian concept in VSE/Advanced Func- 
tions. 


e Virtual I/O for temporary storage of phases between link~editing 
and following execution. 


The material has been reorganized in the form of Diagnosis Reference 


( manuals. 


Summary of Amendments v 
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INTRODUCTION 


System Context 


Input 


Output 


All programs to be executed under VSE/Advanced Functions must be 
prepared first by a language translator and then by the linkage edi- 
tor. According to these stages of preparation, programs may be 
stored in any sublibrary as one of the predefined member types. 


Source modules have a one-character type (A-Z,0-9,#,$,@). 
(Each compiler defines its valid source module types.) 

Object modules have type OBJ. 

Phases have type PHASE. 


The linkage editor can run in any partition. 


Input consists of the linkage editor statements and object modules 
to be linked. Linkage editor statements are ACTION, ENTRY, INCLUDE, 
and PHASE. For the specification of these statements see 
VSE/Advanced Functions System Control Statements, SC33-6095. The 
sequence of sublibraries to be searched for the input object modules 
is defined by a LIBDEF OBJ,SEARCH job statement. This sequence is 
the OBJ-search chain and a sublibrary in this chain is called a 
SEARCH sublibrary. 


Output consists of the phase or phases produced and a linkage editor 
map giving address information about each phase and CSECT. The 
phase produced is stored either temporarily or permanently before it 
can be executed. For // OPTION LINK the phase is stored temporarily 
in the virtual I/O area, an extension of the page data set. For // 
OPTION CATAL the phase is stored permanently in the CATALOG subli- 
brary with an entry in the sublibrary member index. The CATALOG 
sublibrary is defined via the LIBDEF PHASE,CATALOG job statement. 
The member index is updated via library management. The linkage 
editor map is printed on SYSLST after the linkage editor control 
statements and input listing. 
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Invocation 


Job control calls the linkage editor when it reads a // EXEC LNKEDT 
statement. This statement can occur in two different combinations: 


1. To link and catalog: 


An object module is link-edited and the 


resulting phase is permanently stored or "cataloged" in a subli- 
brary. If the phase is re-enterable it can be declared 


SVA-eligible in the 


PHASE statement. The job statements to 


"link and catalog" are: 


// OPTION CATAL 
// EXEC LNKEDT 


2. To link, load, and execute: An object module is link-edited and 


the resulting phase 


is temporarily stored in the virtual I/0 


area and immediately executed. The phase to be link-edited and 
immediately executed must not be part of an overlay structure. 
The job statements to link, load, and execute are: 


// OPTION LINK 
// EXEC LNKEDT 


// EXEC 


MSHP Module Control 


Phases cataloged. under control of MSHP must be maintained via MSHP. 


Such phases are flagged 


in the directory entry as being MSHP con- 


trolled. This flag normally prevents the replacement of the phase by 


the linkage editor when 
To allow replacement of 
MSHP bypass function is 
linkage editor replaces 
indicate that the phase 


not running under control of MSHP. 

such a phase out of control of MSHP, the 
provided. If this bypass is specified, the 
MSHP-flagged phases and sets another flag to 
has been changed without MSHP control. 


The MSHP bypass is specified as PARM parameter as follows: 


// EXEC LNKEDT,PARM='MSHP' 
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Controlled Operator Cancel 


Cancelling a librarian or linkage editor job in a prior release was 
always critical since the library used was in danger to be 
destroyed. For Version 2 Release 1 of VSE/Advanced Functions the 
librarian or linkage editor continues processing up to a point where 
a consistent state of the library is reached whenever a librarian 
command or a linkage editor job is cancelled normally, i.e. not with 
CANCEL FORCE. 

CANCEL FORCE always terminates immediately with risk of library dam- 
age. 


The normal cancel function is controlled by the flags IJBARCNA and 


IJBCNCPD in field JCSW8 of the partition COMREG. These flags are 
set/reset/checked by the linkage editor module INLPLEIT. 
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DESIGN INFORMATION 


FUNCTION 


Input 


The linkage editor adjusts the addresses in the CSECTs of one or 
several object modules so that these CSECTs can be executed together 
as one phase or as several phases in an overlay structure. 


Input to the linkage editor are the linkage editor statements and 
the object modules produced by language translators (assembler or 
compiler). 


Each object module consists of dictionaries (ESD and RLD) and text 
for one or more control sections. 


Six record types can be produced by the language translators out of 
the source input to form a module. They appear in the following 
order: ; 


Rec. Type | Definition 
External symbol dictionary 


| 

| 

| Ignored by the linkage editor 
TXT | Text 

| 

| 

| 


RLD Relocation list dictionary 
REP Replacement to text by programmer 
END End of module 


The dictionaries contain the information necessary for the linkage 
editor to resolve references between different modules. The text 
consists of executable instructions and data fields. 
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Figure 1 shows an overview of the linkage editor input. 


[pn tO ee a eg ee ee ee ee 


Input 


statements modulel module? module3 module4 .. 


| 

| 

| 

| 

| 

| 

| SS SS 
| | | | 

| CSECT1 CSECT2 CSECT3 CSECT4 ... 
| 

| 

| 

| 

| 

| 


| 
a aac 
| | 
dictionaries text 
(RLD and ESD records) (TXT, REP, and END records) 


a ss ee Se 


Figure 1. Overview of Input Units 


The linkage editor can also re-link phases if they have been 
retransformed into modules by the librarian command PUNCH. In this 
way, an already link-edited phase can be recataloged to another 
library and sublibrary. The librarian command PUNCH causes the con- 
tents of a member of type PHASE to be punched as TXT and RLD 
records. 


Since the greatest task of the linkage editor is the adjustment of 
external symbols, ESD records have the most variety. 


ESD RECORDS: The following types of ESD records exist. 


° Section Definition (SD): Consists of CSECT name, assembled ori- 
gin, and length of a named CSECT. Generated by a START or CSECT 
statement in the source module. 


° Private Code (PC): Consists of assembled origin and length of an 
unnamed CSECT. 


° Label Definition or Label Reference (LD/LR): Contains the 
assembled address and the associated SD of a label that may be 
referred to by another module. The LD entry is termed LR (label 
reference) when the entry is matched to an ER entry. 


’ External Reference (ER): Contains the location of a reference 
made to another module. Generated by the assembler instruction 
EXTRN or a V-type address constant in the source module. 


° Weak External Reference (WX): Same content as ER, except that 


WX suppresses Autolink. Generated by the assembler instruction 
WXTRN. 
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Output 


Operation 


* Common (CM): Contains the number of bytes of "common storage" 
needed by a particular phase at execution time. Common storage 
is an area to be reserved at the beginning of the partition for 
shared use between phases. Its most frequent use is for communi- 
cation in an overlay structure. Generated in the source module 
by the assembler instruction COM or directly from the compilers. 


The output consists of the phases produced and a linkage editor map 
giving address information about each phase. See the description of 
the linkage editor map in the Chapter "Diagnostics". 


The program takes the CSECTs out of several modules and combines 
them, in a different selection or sequence if so specified, into 
executable phases. 


Figure 2 shows how phases can be formed. 
ee ee ee 
Sample of a two-module input resulting in a three-phase output 


See 
Language Translator Output Linkage Editor Output 


| | 
| | 
| | 
| | | 
| | | 
| Module A | Phase 1 | 
| ESDs | CSECTA | 
| TXT-CSECTA | CSECTB | 
| TXT-CSECTB | | 
| TXT-CSECTC | Phase 2 | 
| RLDs | CSECTC | 
| End | CSECTD | 
| | CSECTE | 
| Module B | | 
| ESDs | Phase 3 | 
| TXT-CSECTD | CSECTA | 
| TXT-CSECTE | CSECTF | 
| TXT-CSECTF | CSECTG | 
| TXT-CSECTG | CSECTD | 
| RLDs | | 
| END | | 

| 
a ee 


Figure 2. Example of a Module-Phase Relationship 


When the linkage editor reads a module, it stores the ESD records in 
its control dictionary (CD), writes the information from the TXT and 
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REP records into the sublibrary, and the RLD items on an internal ) 
buffer called RLD buffer. If the RLD buffer is full, its content is | 
written on workfile IJSYSO1. 


The CD contains the information to find each CSECT and to resolve 
any reference between CSECTs. 


The language translator gives each ESD record a number called ESID 
number. The linkage editor gives it a CD number unique in the phase, 
because the same ESID number might occur several times coming from 
the different modules. 


In detail, the linkage editor does the following: 
1. Relocates the origin of each CSECT in the phase: 

The relocation factor for each CSECT is determined and saved in 

the CD. ) 
2. Assigns to each phase an area of storage, determines its trans- 

fer address, and combines the module TXT records into phase 


blocks using librarian services. 


3. Resolves address cross references across CSECTs or phases in 
overlay structures. 


4, Adjusts the contents of the address constants (ADCONs) in the 


phase and inserts them in the text. These ADCONs are identified ) 
in the RLD. Unresolved ADCONs appear in the phase as zero RLD 
items. 


As we have seen above, the linkage editor allows the inclusion of 
the same control section (CSECT) within each of several phases. If 
a CSECT appears in a ROOT phase, it does not appear in any other 
phase. (This does not apply to CSECTs that begin with the letters 
IBM.) A duplicate CSECT within the same phase will be ignored. 
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C 


The following examples show how external references are resolved, 
depending on whether or not a ROOT phase exists. The first example 
shows how external references are resolved when there is no ROOT 
phase: 


PHASE ONE 
CSECT A 
OQ) 
V 
CSECT B<——_1—__ 
| 
PHASE TWO | 
CSECT A | 
V(B)—_____ 


CSECT B<——— 

| 

PHASE THREE | 
CSECT A | 
V(B)——_! 


CSECT B 


PHASE FOUR 
CSECT A 
CSECT B<——\ 


V(B)——— 


The second example shows the resolution of external references with 
a ROOT phase: 


ROOT-PHASE ZERO 
CSECT V 
ENTRYPOINT X<——+~———_ 
A 
PHASE ONE | 
CSECT A | 
V(X) 
CSECT B 
ENTRYPOINT X 


PHASE TWO 
CSECT A 
CSECT B 
ENTRYPOINT X 


Privileged external references (names beginning with the letters IJ 
or IBM) are always resolved within the current phase or the ROOT 
phase. If this is not possible, the resolution will be attempted at 
the end of the phase via the AUTOLINK function (if NOAUTO is speci- 
fied, the IJ or IBM prefix is not privileged). The other previously 
defined phases are not examined for possible resolution. If an 
external reference does not match the name of a module in the subli- 
braries to be searched, it will be an unresolved external reference. 
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Autolink 


The following example shows the resolution of privileged external 
reference: 


PHASE ONE 
CSECT A 
V(IJxx)-——__ 
V (IBMx)— 
VQ 


r-——>CSECT B<— | 
CSECT IBMx<—— 
CSECT IJxx<————~ 


CSECT A 


V( I Jxx )—-——_ 
V(IBMx)————___ | 
\___v(B) | | 
CSECT B | 

CSECT IBMx<—__ | 
CSECT IJxx<-———_ 


Autolink is a feature that works automatically when a new PHASE or 
an ENTRY statement indicates that the preceding phase is finished, 
unless the user has suppressed it by a PHASE NOAUTO statement, by an 
ACTION statement option, or by the assembler instruction WXTRN in 
the source module. It is located in the CSECT IJBLNK together with 
the general input control. 


What it Does 


Autolink tries to find in the sublibrary OBJ-search chain a module 
to resolve any unresolved-external reference (ER) from the preceding 
phase. 


How it Operates 


Whenever an external symbol (ER) is encountered Autolink searches 
the sublibraries specified in the OBJ-search chain for the module of 
the name indicated by the ER. The module is then treated as an 
INCLUDE statement, that means, it must also contain an entry with 
the same name as the ER which is being resolved. 
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CC How the Linkage Editor Calculates Addresses 


The assembled origin is the address of a CSECT within its object 
module. This assembled CSECT origin can be declared by assembler 
statements. Default is 0 for the first, 0 + length of the first for 
the second CSECT, and so on. 


0 500 1500 


[Ct eee ee ea 
| CSECT1 | CSECT 2 | CSECT 3 
——___—=_________—__—_S___S_ ———— 


The phase origin is the address to which the phase is linked. This 
address can be specified in the PHASE statement. The default is the 


beginning address of the linkage editor partition plus the length of 
4 the save area. 


The expression "phase origin" is used also for the beginning of each 
CSECT after it was linked into a phase. 


The difference between the assembled origin and the phase origin 
then is called the relocation factor. 


r—Start of Virtual Storage 
r—Start of Linkage Editor Partition 
| | "Phase Origin 
| | | 
Se V V V 
| | 


save area | phase------- > 
|<----relocation factor---->| (if assembled origin was 0) 

If the assembled origin of the phase was 0, the relocation factor is 
the amount of the address of the phase origin. If it was 500, the 
relocation factor is the phase origin minus 500. 
— If the phase is relocatable and is loaded somewhere else later, the 
address where it is loaded is called the load origin. And now the 
relocation factor is the new difference between the assembled origin 
and the load origin. 


In general, the following formula is true: 


assembled origin + relocation factor = phase or load origin 
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I/O FLOW AND LIBRARY ACCESS CONTROL 


As explained in the introduction to this manual, library access is 
gained for the linkage editor by job control via the LIBDEF state- 
ment. Input modules are accessed by a LIBDEF OBJ,SEARCH statement. 
The CATALOG sublibrary to which the output phases are written is 
defined via LIBDEF PHASE,CATALOG statement. 


The CSECTs IJBINL, IJBOTH, IJBCAT, IJBRLD, and IJBFIN, each call the 
interface CSECT INLPLEIT which handles all the interfaces with the 
librarian via librarian macros and control blocks, the stow table, 
and service buffers for reading from and writing to the sublibraries 
and the CATALOG sublibrary member index. 


The temporary output of a phase to the VIO area is done by the vir- 
tual I/O (VIO) routines of the supervisor which are called also by 


CSECT INLPLEIT using the macro VIO with the operands OPEN, MOVE, or 
EXTND. 


Figure 3 shows the I/O flow in the linkage editor program. 
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SYSLNK SYSO01 


Sublibraries Workfile 
chain 


\l Ze 


———— 
Link 
Eanoe VIO Area 


iene 


CATALOG 


Sublibrary 


Input comes from: Output goes to: 
SYSLNK - Control stmts and modules CATALOG sublibrary 
OBJ-search chain of sublibraries VIO area for phases to be 
for input modules executed immediately 


IJSYSO1 - Workfile for RLD records SYSLST - List device 
SYSLOG - System console 


SS ES 
a ee ee ee 

— — SS SS 
— el — ——— — 


Figure 3. I/O Flow 


PROGRAM LAYOUT IN THE PARTITION 


As Figure 4 shows, the program in the partition starts out with the 
root of the phase, CSECT IJBLNK. Then follow all other CSECTs of 
which CSECT (and module) INLPLEIT is the last one. It is followed by 
work buffers and tables, and the CD with a fixed beginning but vari- 
able length. The lengths of the P- and S-buffers are calculated from 
the high end of the partition down to the end of the CD. 
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.-—. -  ——— Ge ea et ee Pe 


Program Part: Size: 
Partition Start ———— | 
| IJBLNK | | 


| and all other CSECTs | | 


| | 
| | 
| | 
| | 
| | 
| | 
| | SYSLNK Buffer | 328 bytes| | 
| | LIFO Stack | 210 bytes | | 
| | RLD Buffer | 2K bytes| | 
| | 
| | Linkage Table | Stow Table | 1540 bytes| | 
| | 
| | Control Dictionary | variable | | 
| | 
| | P-Buffer for reading object | 9496 or | | 
| | modules | 17532 | | 
| | 
| | P-Buffer for | SMAP |See follo- | | 
| | handling phases | processing |wing figure| | 
| | 
| | S-Buffer for librarian access | 4904 or | | 
| | | 6052 | | 
| Partition End 9 9°3°¢-—-——————— _—__41____ | 
| | 
| Areas Pointer Names in CSECT IJBLNK | 
| | 
| SYSLNK buffer FLNBUF | 
| LIFO stack LCSTBEG | 
| RLD buffer for IJSYSO1 RLDBUF | 
| Linkage tables LTMINE | 
| Control dictionary (CD) CDENT1 | 
| Last entry in CD CTLDAD | 
| Upper limit for CD TENK | 
| P-buffer for phases PHAPBUF | 
| P-buffer for modules OBJPBUF | 
| S-buffer SHARBUF | 
| | 


as a 5 i eh eed) 


Figure 4. Partition Layout 


The S-buffer and the P-buffers are formatted by the librarian. The 
S-buffer is the shared buffer for library management of the CATALOG 
sublibrary; the P-buffers are used for member I/O. 

(For a complete description of the S- and P-buffers see VSE/Advanced 
Functions Diagnosis Reference: Librarian LY33-9111) 


Figure 5 shows how the buffer sizes depend on the partition size. 
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up to 256K | 4904 


over 256K 


| 
| 
| 
| 6052 


Partition | S-Buffer P-Buff.for Mod. P-Buffer for Phase 


9496 ) 3/4 of storage between start of 
) CD and start of S-Buffer, minus 

17532 ) length of P-Buffer for modules 
) 


(up to a maximum of 150K) 


Figure 5. Approximate 


Buffer Sizes in Relation to Partition Size 


FUNCTION-TO-CSECT OVERVIEW 


The program consists of one phase S$LNKEDT. This phase consists of 
two modules, INLPLEIT and IJBLE1. INLPLEIT consists of one CSECT of 
the same name; IJBLE1 consists of a number of CSECTS whose names all 
begin with IJB. The functions of the CSECTs, in the order as they 
are called, are the following: 


IJBINL 


INLPLEIT 


IJBLNK 


IJBOTH 


IJBFIN 


IJBESD 
IJBSCN 


IJBCTL 


Serves as entry point to the program. Initializes linkage 
editor processing. Processes ACTION statements. 


Calls librarian routines or VIO routines of the supervi- 
SOIL. 


Contains common subroutines and constants. Processes 
linkage editor input. Branches to appropriate CSECT. Per- 
forms Autolink. 


Processes TXT, REP, RLD, and END records. 


Finds records and modules from SYSLNK and from SEARCH sub- 
libraries. Formats messages. 


Processes ESD records. 
Processes INCLUDE, PHASE, and ENTRY statements. 


Pre- and post-processes PHASE and ENTRY statements. 


After ENTRY-statement: 


IJBMAP 
IJBRLD 


IIBCAT 


Prints linkage editor map. 

Relocates ADCONs in each phase and generates the corre- 
sponding RLD records to be used by FETCH/LOAD or by the 
linkage editor if the phase is re-linked. 


Updates the member index of the sublibrary. 
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PHASE DESCRIPTION FOR PHASE $LNKEDT 
ENTRY POINT: IJBINL 
FUNCTION: Transforms modules of a program into executable phases. 
(For details see "Sequence of Operation" in the CSECTs.) 
CALLED BY: Job Control or MSHP 
PHASES CALLED: SIJBLBR (Librarian) 
DATA AREAS USED: 

I/O areas 

Linkage tables 

Control dictionary 

LEITPL (Communication area to librarian) 

Buffers for librarian services 

Stow table (librarian) 


LIFO stack 
Librarian interface control blocks used by INLPLEIT 


MESSAGES CAUSED: See Message-to-CSECT Cross Reference 
MESSAGES ISSUED: All by CSECT IJBLNK 
INPUT: Statements and object modules 
OUTPUT: Phases and linkage editor map 
EXIT NORMAL: Caller 
EXIT ERROR: Cancel 
REGISTER USE: 
R10 Base Register for IJBLNK 
Rll Base Register for IJBFIN 
R10/11/12 Base Registers for INLPLEIT 
R13 Base register for all other CSECTs 
SEQUENCE OF OPERATION: The sequence of operation is listed in the 
following by CSECT, in the order of their execution. The most impor- 


tant labels are given on the left side and the operation which they 
mark on the right side. 
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CSECT IJBINL 


Called By: Job Control 


IJBINL : - Calculates relocation factor. 

OPCATAL : - Opens SYSLST and SYSLNK. 

CALCWA : - Calculates storage addresses for: 
-- I/O areas 


-- Linkage table 
-- Control dictionary 
-- Buffers for librarian services 


-- Stow table 
- Gets partition start address and checks size. 
CONCLIB : - Calls INLPLEIT to get access to CATALOG sublibrary. 
INLNOOO : - Reads from SYSLNK. 
NXTCARD : - Processes ACTION statement if there is one. 
INTER100: - On finding a non-ACTION statement ----> IJBLNK 
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CSECT INLPLEIT 
Called By: IJBINL, OTH, ESD, FIN, RLD, CAT 


CSECT INLPLEIT uses or modifies the following librarian and 
Supervisor macros: 
INLMFIND 
INLMGETR 
INLMLAMB 
INLMLDIS 
INLMLRPL 
INLMMCON 
INLMMDIS 
INLMNOTE 
INLMPOIN 
INLMPUTR 
INLMSCON 
INLMSTOW 
LBRACCCB 
LBRACCES 


VIO EXTND 
VIO MOVE 
VIO OPEN 


and the following librarian and supervisor control blocks: 
INLCDENT 

INLCLAMB 

INLCLARG 

INLCLPT (field LPTVIOTB) 

INLCLRPL 

INLCMACB 

INLCSACB 

LBRACCDS 


MAPVIORB 


This is how it operates: 
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OPENC 


OPENJ 


CONNECT: 


WRITE 


UPDATE : 


READ 


FINDM 


NOTEM 


POINIM : 


STOWML : 


LEITFIND: 


Builds CATALOG sublibrary control blocks 

using the macros: 

INLCDENT to generate structure declarations for the 
control blocks INLCDENT (stow table entry) 

INLCLARG (any search argum.) 

LBRACCCB to initialize the control block LBRACCDS 

INLMLAMB to initialize the control block INLCLAMB 

INLMLRPL to initialize the control block INLCLRPL 

LBRACCES to connect to the specified CATALOG sublib. 

INLMSCON to initialize the control block INLCSACB 

Sets flag IJBARCNA in partition COMREG to establish the 

delayed cancel function in order to keep a consolidated 

library structure for a normal cancel request. 

Opens virtual I/O control block if option was LINK 

using the macro VIO OPEN which initializes the control 

block MAPVIORB. The MAPVIORB pointer is inserted 

into the table pointed to by field LPTVIOTB in control 

block INLCLPT. This table is in the system GETVIS area. 

Builds library control block INLCLRPL using the 

macro INLMLRPL for requests to the OBJ-search chain. 

Uses routine LEITFIND to establish if a phase of the 

Same name as the output phase is in some sublibrary. 

If MSHP is active, the phase is replaced in the same 

sublibrary. 

If MSHP is not active and the phase is not under MSHP 

control, the phase is replaced in the specified CATALOG 

sublibrary. 

Uses the macro INLMMCON to build control block INLCMACB. 

Writes text information into CATALOG sublibrary 

using macro INLMPUTR. 

Writes text information into VIO area, if option LINK, 

using macro VIO MOVE. IF necessary, extends the 

virtual storage allocation using macro VIO EXTND. 

Updates ADCONs in already processed phases 

using macros INLMGETR and INLMPUTR. 

Updates ADCONs in phase already in VIO area, if option 

LINK, using macro VIO MOVE. 

Reads OBJ records from object modules 

using macro INLMGETR. 

Finds member from OBJ-search chain 

using macro INLMFIND. 

Notes position in object module 

using macro INLMNOTE. 

Re-positions in OBJ member 

using macro INLMPOIN. 

Catalogs phases specified in the stow table 

using macro INLMSTOW. 

Establishes target sublibrary by finding the phase to 

be replaced, if the linkage editor runs under MSHP. 

If phase is MSHP controlled, allows replace only 

under MSHP. 

The routine uses the macros INLMFIND, INLMMDIS, 

INLMLDIS, LBRACCES, and INLMSCON. 
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CSECT IJBLNK 


Subroutines in IJBLNK 


20 


Called By: 


CDENT1 
LTMINE 


SHARBUF : 
PHAPBUF : 


OBJBUF 
LEITPL 


LCSTBEG : 


CPHENT 


CESDENT : 


ALNKPR 


RDNEXT 
RDEXEC 


IJBINL, SCN, 


- Points 
- Points 
- Points 
- Points 
- Points 


to 
to 
to 
to 
to 


CTL, OTH, ESD, FIN 


control dictionary (CD) in partition 
Linkage Table in partition 

buffer for CATALOG sublibrary access 
buffer for CATALOG sublibrary access 
buffer for OBJ-search chain access 


- Communication area between INLPLEIT and other CSECTs 
- Header of LIFO stack for nested INCLUDEs 

- Current phase entry 

- Current ESD entry 


- Searches the control table for unresolved ER's and 
initializes for Autolink. 
- Reads "cards" from SYSLNK or SEARCH sublibrary. 
- Passes control to: 
eee eee ------ > IJBSCN (Control statement) 
were c eer n cree > IJBESD (ESD records) 
cee ce esse scee-- > IJBOTH (TXT,REP,RLD records) 


As the first CSECT (IJBLNK) of the linkage editor program, IJBLNK 
contains most of the subroutines used by other linkage editor 


CSECTs. 


After processing any of these subroutines, control is 


returned to the calling routine if not indicated otherwise. 


The following list shows name, main entry points, and function of 
each routine. 


Subr. Entry Function 
LTESID: Input to this routine is an ESID number supplied by the 


language translators. 


LTESID If CD number is: 


zero: The ESID number was not yet processed. 


Returns to the address in the link 
register. 


negative: The ESD record is bypassed. Returns to 


link register + 4. Addresses of the 
linkage table entry and the control 
dictionary number are supplied. 


positive: Returns to register + 8. Relocation 


factor for SD/PC, control-dictionary 
-number and -address are supplied. 
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Subr. Entry Function 
SRCHCD SRCHCD Searches the CD for a matching label. 


SRPCOD Continues the search after a matching label has 
been found. 
CNVHEX CNVHEX Converts EBCDIC input into hexadecimal output. 
PRINT PRINT £Prints messages and link map on SYSLST. 
LOGMSG LOGMSG Prints error message on SYSLOG. 
PRTLST PRTLST Prepares for printing the linkage editor 
diagnostics of input. 
SPACE1 SPACE1 Spaces one line on SYSLST. 
XTPHNO XTPHNO Extracts the phase number from CD entries for 
SD, PC, LD, or LR records. 
XTPHGT Entry XTPHGT is used if the entry is known to be 
an SD or PC. 
ABTERR ABTERR Gives control to -----r-r----- nnn H--- > IJBRLD 
for handling of an abnormal termination error. 
CDSIZE CDSIZE Checks for CD overflow. 
ALNKPR ALNKPR Initializes for the scanning of the sublibrary 
member index for Autolink. Extracts 
unresolved ERs from the CD in collating sequence 
and includes the corresponding modules. 
ALNKOF ALNKOF) Reads the input stream and diagnoses the type of 
RDNEXT) statement to pass control to the appropriate CSECT. 


RDEXEC) Entry at RDEXEC skips reading of statement. 
EXLOAD ) 
CANCL CANCL Cancel routine. 
ERROR ERROR Sets up to print non-termination error messages. 
If the calling routine sets the RETRN bit in ERRSW, 
returns to caller. If RETRN is off, returns to 
RDNEXT or ALNKPR if error during Autolink. 
NOTCTL NOTCTL Converts input statements (X'02' in first byte) to 
print format. 
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CSECT IJBOTH 
Called By: IJBLNK 


IJBOTH : - Initializes IJBOTH. 
- Branches to the right processor for the statement at hand: 


ee tercr--- >ENDPRC 
TXTPRC : TXT processor 
- Puts text into CATALOG sublibrary format. 
- Calls INLPLEIT to write text. ------- > RDNEXT (CIJBLNK) 
REPPRC : REP processor 
- Modifies REP to text. 
- Processes in TXTPRC. ---------------- > RDNEXT (CIJBLNK) 
RLDPRC : RLD processor 
- Converts R and P pointer information to CD 
number information for RLD pass 2. 
- Stores RLD records in buffer (writes to IJSYSO1 
if necessary.) -r<crcr rete rc src rero=- > RDNEXT (IJBLNK) 
ENDPRC : END processor 
- Updates input control mechanism (LIFO stack PERIDA). 
- Supplies transfer address. 
- Identifies unassigned LD/LR in control 
dictionary for this module. 
- Clears the linkage table. 
- Accepts CSECT length if necessary. (Some 
language translators supply CSECT length 
in end record.) 
- If Autolink necessary 
COGS. LO: = SSs-Sseeees=--=>55 > ALNKPR (IJBLNK) 
Else goes to -----+--++---- > RDNEXT (CIJBLNK) 


CSECT IJBFIN 


Called By: IJBLNK 


READIN : - Controls record I/O. 

LNKPOINT: - Points to next record. 

LNKNOT : - Notes record. 

LCFIND : - Finds module. 

IJBLETR : - Handles messages. 

LEITCALL: - Calls INLPLEIT for librarian services. 

LCLOSE : - Disconnects all connected libraries and sublibraries. 
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C 


Aha 


CSECT IJBESD 


Called By: IJBLNK 


IJBESD : - Controls input for updating LIFO-stack PERIDA. 


- Builds dummy PHASE statements if none supplied. 


ESDRET : - Checks validity of type code for ESD record. 


ELBCM 
ELBSD 
ELBLD 
ELBER 


- Exits if all ESD records are processed. 
- If end-of-record or SYM record found 
goes tO -rrrerererc cre -e > RDNEXT (IJBLNK) 
Else preliminary processing of SD/PC/LD/ER/CM records. 
- Compares label on input ESD with CD. 
- Completes SD/PC processing by ensuring that 
name field on ESD record is blank. 
- Completes processing: 
- CM 
- SD/PC 
- LD 
- ER 
- If no dictionary update --------- > ESDRET 
- Else: 
-- Posts ESD record in CD. 
-- Moves CD number to linkage table. 
-- Checks for CD and linkage table overflow. 
==.GOES ‘CO°.-==S-523ossSeeseesetee- > ESDRET 


In detail, ESD processing takes the following steps: 


Pre-Process ing 
iL 


For 


each ESD record produced by a language translator, an input 


CD entry is built at a fixed location in storage. In some 
cases, this input CD entry is moved to the CD during processing. 


The 


input ESD type field is validated. 


If it is a weak external, the ESD type field in the input CD 
entry is set to ER and the NOAUTOL and WXTRN bits in CSWITCH 
are turned on. 


If it is invalid, an error condition exists, the whole ESD 
record is ignored, and the next ESD record is processed. 


Further preprocessing depends on the ESD type: 


For LD input: An LD record has a pointer to the linkage 
table where the CD number is checked to see if the LD record 
has already been processed. 


For ER input: If NOAUTO was specified, the NOAUTOD bit in 
CSWITCH is set on. 
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Processing 


° For SD or PC input: Two conditions must be fulfilled: 


a. The assembled origin must be aligned on a double-word 
boundary. 


b. The PC must be unnamed. 


The relocation factor is calculated by subtracting the 
assembled origin from the storage address (NXPHRG). 


For a normal INCLUDE, pre-processing is finished at this stage. 


For a submodular INCLUDE, the name list of included CSECTs is 
scanned for a name identical to the name of the input CD entry. If 
the names match, pre-processing is finished. If not, the ESD type 
field in the input CD entry is changed to ER and a switch is set to 
ensure that the CD number in the linkage table is given a negative 
value. 


The CSECT scans the CD for an entry with the same name as the 
input ESD. 


This scan starts at the end of the CD and proceeds towards the 
beginning until either a match occurs or the beginning of the CD 
is reached. If a match occurs, the CD entry is called a dupli- 
cate. 


The scan continues if the duplicate is a phase entry. 


If no duplicate is found, the input CD entry is added to the end 
of the CD. 


If the input ESD is an SD, PC, CM, or ER, an entry is made in 
the linkage table. 


If a duplicate is found, the action taken by the ESD processor 
depends on the relationship between input and duplicate. Figure 
6 shows all possible actions and their abbreviations Al to 
Err-46. 
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Qe" thy 


Oe ee ee ee ee ee ee ay 


Action Meaning 


Err-43: Prints error message '2143I' and goes to RDNEXT. 
Err-46: Prints error message '2146I' and goes to RDNEXT. 


| 

| 

| Al: Ignores input CD entry. 

| <A2: Adds input CD entry to the end of CD. 

| A3: Replaces duplicate with the input CD entry. 

| A4*: Adds the linkage table entry pointing to the last entry 
| added to the CD. 

| A5*: Adds the linkage table entry pointing to the duplicate. 
| A6: Changes duplicate LD to LR. 

| 

| A8: Saves length of longest CM in CD. 

| <A9: Gives CD number in linkage table a negative value. 

| A10: Changes input LD to LR. 

| All: Sets ‘Possible Duplicate Entry' switch. 

| 


| 
| 
| 
| 
| 
| 
| 
| 
A7: Continues scan of CD. | 
| 
| 
| 
| 
| 
| 
| 
| *If a submodular INCLUDE was used and the name list of included | 
| SDs does not contain an SD, the CD number in the linkage table is | 
| given a negative value. | 


ee a a SER eed SSP ee ce Ser eee acne ee 


Figure 6. ESD Processing Actions 


To find which action is taken while processing input CM, ER, SD, 
or LD records, use Figures 7 to 10. The upper part of these 
figures shows the various conditions which exist (Y), do not 
exist (N), or can be ignored (-), while the lower part indicates 
the actions taken (X). 


nn 8 ee 


Ee I ee ee pe ge ee yg ee ee ee ee ee al 
| | 
| Duplicate = SD | YNNNN | 
| = PC | NYNNN | 
| = CM | NNYNN | 
| = LD/LR | NNNNY | 
| = ER | NNNYN | 
7 eden’ acameian ie eae | 
| A3 J ~--X- | 
| a4 [| eres | 
| AS | -XX- | 
| 7 Pee | 
| A8 | --X-- | 
| Err-46 | ccf | 

ak eh et 


Figure 7. Decision Table if Input is a CM Record 
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Duplicate SD, LD, or LR 
LD 

CM 

ER 

Duplicate unassigned * 
Name = 'IJ..' or 'IBM..' 
Name = 'IBM..' 

NOAUTO for input 

Duplicate in current phase 
Duplicate in ROOT phase 


ZAAAAKM AAAI K 
('2]2AnKhenKe Saat K 

reine SAAAK 
re Zine 2SaAamaakKk 
KZA AAhKAAAAK 


* SD is to be considered assigned 


Weak externals are processed like ERs for which NOAUTO is requested. 


reine S]2AaKe 
re Aine s]y™azanKe 


-XXXX----- 


Figure 8. Decision Table if Input is an ER Record 


[eee ge ee we ee ee eee ee a ee 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


Duplicate 
CM 
LD or LR 
ER 
Duplicate unassigned 


Input and dupl. ESIDs agree| 
ASSORGs agree| 


Duplicate in current phase 
Name = ‘IBM..' 
Duplicate in ROOT phase 


a 


| 


Figure 9. Decision Table if Input is an SD 


| 
YYNNNNNNNNNN | 
NNNNNNNNNNNN | 
NNYYYYYYYYYY | 
NNNNNNNNNNNN | 
--NNNYYYYYYY | 
----- NNNYYYY | 
--- +--+ NNNY | 
NN-YN-YN-YN- | 
NNNYYNYYNYY- | 
NY--- ee eee ee | 
| 
X---X--+X--X- | 
de CSE, ian Gast Teel ee ese - ee one, estos X | 
X---X--X--X- | 
-X---+-+--+-+-- x | 
fee ee eh ee cet, es eee. tee er 2 | 
--xXX-XxX-XX-- | 
ee 

Record 


26 VSE/AF Diagnosis Reference Manual: Linkage Editor 


%* Action A3 is performed retaining the ESD type of the duplicate 
*#* SD is to be considered assigned 


| | 
| Duplicate = SD, LD, or LR |NNNNYYYYYYYYYYYYYYYvyY | 
| = CM |YNNNNNNNNNNNNNNNNNNN | 
| = LD or LR |NNNN---- - YYYYYYYNNNN | 
| = ER |INYYYNNNNNNNNNNNNNNNN | 
| Duplicate unassigned ** | ----NNNNNNNNNNNY---- | 
| Input unassigned | ------- YYNNNNNN-NNNN | 
| Input points to duplicate | -------+-+-+-+----e- YNNN | 
| Input and duplicate point | --------- YNNNNN----- | 
| to the same entry | | 
| Names of C/D entries agree | - --------- NNNYY----- | 
| Name of input and duplicate| -NYYNYY---NYY----NYY ! 
| = 'IBM...' 

| Duplicate in current phase | - - YN-NYNY--NYNY---NY | 
| Input and duplicate ASSORGs| - - --NNNYYYYYYYY-YYYY | 
| agree | ! 

SEES 

| Al | ----- ee XX----°X-X--- | 
| A2 |} ---X-X¥-X---X-X----X- | 
| A3* |} -XX-- ++ -- ee ee ee X¥- - - - | 
| A10 | -XXX-r ee eee ee ee ee eee | 
| All | ---- ee ee X--+ +c? XX---- | 
| Err-43 J} ----+X-X---X-X----X- | 
| Err-46 | X- ee ee ee ee ee ee ee ee ee | 
| | 
| | 
| | 
| | 


i 


Figure 10. Decision Table if Input is an LD Record 


Post-Processing 


1. For ER, LD/LR, or CM input, the next ESD record is selected for 
processing. 


2. For SD or PC input 


a. The CD is scanned for unassigned LDs or LRs pointing to the 
input record. 


b. The CD entries found during the previous scan are updated. 
This is done by storing in the CD entry the CD number found 
in the linkage table entry that corresponds to the input 
item. 


c. The storage address (NXPHRG) is updated by adding the length 
of the CSECT. 
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If the length of the CSECT is provided in the END statement, CSECT 
IJBOTH performs action c. 


CSECT IJBSCN 
Called By: 


IJBSCN : 


INCCRD : 


PHCRD 


ENTCRD : 


CSECT IJBCTL 
Called By: 


IJBCTL : 


WRTRFR : 


PHSPRC : 


IJBLNK 


- Controls input for updating PERIDA. 
- Finds operation field and checks validity. 
- Branches to the processor for this type of statement: 


INCLUDE statement processor 
- Checks validity of operands. 


- If no operand, -erec tcc cree ee > RDNEXT (CIJBLNK) 
- Else locates module to be included and autolinks. 
> BOGS: CO). SSS SseoaaseseSsessessSe= > RDNEXT (IJBLNK) 


: PHASE statement processor 


- Checks validity of operands. 


- If Autolink required ----------- > ALNKPR (IJBLNK) 
> BILS€ S06S CO Sse ros esssese== > IJBCTL 


ENTRY statement processor 
- Provides exit from ENTRY or PHASE statement processors. 
- Saves transfer address if in ENTRY statement. 


= “bt AUColink ==S=sSe-Sess65—3S4= > ALNKPR (IJBLNK) 
= EIS e@- goes: Lo: eSsssSsaSsesscceees > IJBCTL 

IJBSCN 

= [f-“first phase: -“s-Se=s+ss<5-s=se= > PHSPRC 

[ID ISe. 2S Scsesanoss Sarre S- SS Ses Ss > WRTRFR 


PHASE post-processor 
- Reserves space for relocation information. 


- If Autolink ---ec-s9-- rete ere - > ALNKPR (IJBLNK) 
- Else 

-- If PHASE statement ------------ > PHSPRC 

-- If ENTRY statement ------------ > IJBMAP 


PHASE pre-processor 

- Determines optional operands specified. 

- Builds current phase CD entry. 

- Gets information to processing phase. 

- Determines if relocation possible. 

= GOES LO PS SeseSes SSesesee5SSss-S-5- > RDNEXT (IJBLNK) 
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.. CSECT IJBMAP 
Called By: IJBCTL 


IJBMAP : - Displaces phase load address by cumulative length 

of commons. 

- Calculates load origin for transfer address. 

- Sorts CSECTs by load address. 

- If option SMAP, sorts CSECT names alphabetically 
and produces list. 

- If option MAP prints map. 

- Exits depending on errors and option CANCEL. 


Goes: LO: =Ss=SsSss2=-s655= > EQJ or IJBRLD 
{ CSECT IJBRLD 
Called By: IJBMAP 
IJBRLD : - If no more RLDs -------- > TSTUNR (IJBRLD) 
Pass2 P-pointer processor 
-- Reads RLDs. 


-- Gets relocation factor for P-pointer. 
-- Calls INLPLEIT to move the correspondent CD entry 
to the current phase entry, if the P-pointer is 


P outside the current phase. 
( -- Control flow in IJBRLD depends on conditions found. 
RLDOR : Pass2 R-pointer processor 


-- Gets relocation factor for R-pointer. 
-- Adds the assembled origin (i.e. the address of the SD, 
PC or CM that defines the ER) if R-pointer is an ER. 
-- If a constant must not be processed ---> IJBRLD 
RLDCON : Pass2 RLD constant processor 
- Adjusts constant portion of RLD record by 
relocation factor. 


- Calls INLPLEIT to update ADCONs in phase 
‘e text in CATALOG sublibrary ---------- > IJBRLD 
TSTUNR = If RED PASS: 3 =s<s==S-S-]sse>se see > WRLST (IJBRLD) 
= If MAP: Option. =-<-==-sssesss<s--S=e+5 > TSTCNT 


TSTCNT : MAP routine 
- Lists unresolved ADCONs. 
- Lists ADCONS outside of limits of current phase. 
- If phase not relocatable ------------ > WRLST (CIJBRLD) 
- Initializes Pass3 RLD processing. 

-- Modifies Pass2 RLD processor to insert relocation 
information for relocatable phases in space 
reserved by WRTRFR (IJBCTL). 

-- Positions at start of RLD information. 

- Adds RLD information to phase text. 
WRLST : Block phase header 

- Calls INLPLEIT to write last buffer to library. 
‘< - Closes SYSLNK and IJSYSO1 and -------- > IJBCAT 
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CSECT IJBCAT 
Called By: IJBRLD 


IJBCAT : - Starts stow table. 
- Initializes CD search. 
SCANCD : - Locates next phase entry in CD. 
- If end of stow table: 
- Calls INLPLEIT to update sublibrary member index or, 
in case of a previous severe error, deletes the 
phases already written into the CATALOG sublibrary. 
- Starts new stow table. 
- Modifies load and transfer address of phase in process. 
- Adds entry to stow table. 
- If more entries in CD, rect erect rt tees reer re---- > SCANCD 
- Calls INLPLEIT to disconnect any CATALOG sublibrary 
or SEARCH sublibrary connected. 
- Sets return code into MSHPRET: 
0 if successful link 
4 if warning or error issued, but phases are cataloged 
16 if severe error 
- Returns to caller (MSHEOJ) 
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ORGANIZATION INFORMATION 


Figure 11 shows how the CSECTs of the program are given control dur- 
ing a linkage editor run. 


NBINL INLPLEIT 
Initializes Calls librarian 
Reads ACTION services 
statement 


IJBSCN IJBLNK 
Scans INCLUDE, Root CSECT 
PHASE, and 


ENTRY statements 


IJBCTL 
CaENe IJBOTH IJBESD IJBFIN 
statements Processes TXT, REP, Processes ESD Finds modules and 
RLD, and END records records 
records 


IJBMAP 
Prints linkage editor 
map 


IJBRLD LIBCAT 
Processes RLD Updates library Return 
records directory to Caller * 


INLPLEIT 
Calls librarian 
services 


*)The caller can actually be job control or MSHP. 


Figure 11. Control Flow 
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DATA AREAS 


LIBRARY RECORD FORMATS 


The linkage editor input records coming from the library have the 
format of library members of type OBJ. The records for output have 
the format of library members of type PHASE. 


Input Record Formats 


The input records for the linkage editor are in card image format: 


The ESD Record 


Card Columns 


1 


Li = 
i= 


a 


4 
12 
16 


72 


Hex 02; identifies a loader record. 

ESD record 

Number of bytes of information contained in this record 
ESID number of the first SD, PC,CM, or ER on this 
record. Relates it to a CSECT. 

Variable information: 


8 positions - Name 
1 position - Type code hex 00, O01, 02, 04, 05, or OA, 


to indicate SD, LD, ER, PC, CM, or WX. 


3 positions - Assembled origin 
1 position - Blank 
3 positions - Length if SD, CM, or PC. If LD, ESID number of SD 


containing the label. 


73 - 80 May be used by the programmer for identification. 


The TXT Record 


Card 


Columns 
Hex 02; identifies a loader record. 
4 TXT record 
8 Assembled origin (address of first byte to be loaded 
from this record) 
12 Number of bytes of text to be loaded 
16 ESID number of the CSECT (SD or PC) containing the text 
72 Up to 56 bytes of text -- data or instructions to be loaded 
80 May be used for program identification. 
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The RLD Record 


Card Columns 


i Hex 02; identifies a loader record. 
2 - 4 RLD record 
11 - 12 Number of bytes of information contained in this record. 
17 - 72 Variable information: 
2 positions - R-pointer: 


pointer to the ESID number of the ESD on which the 


relocation factor or the contents of the ADCON depends. 


2 positions - P-pointer: 
pointer to the ESID number of the ESD on which the 
position of the ADCON depends. 


1 position - flag bits indicating type of constant: 
0 - 2 ignored 
3 0 - a non-branch type load constant 


1 - a branch type load constant 
4 - 5 00 - load constant length = 1 byte 
01 - load constant length 2 bytes 
10 - load constant length 3 bytes 
11 - load constant length = 4 bytes 


6 O - relocation factor is to be added 
1 - relocation factor is to be substracted 
7 O - Next load constant has different R- and P-pointers. 


R and P must be present. 
1 - Next load constant has the same R- and P-pointers. 
Therefore they are both omitted. 


3 positions - assembled origin of load constant. 


73 - 80 May be used for program identification. 


The END Record 


Card Columns 


i Hex 02; identifies a loader record. 
2 - 4 END record 
6 - 8 Assembled origin of the label supplied to the assembler in the 


END record (optional) 

15 - 16 ESID number of the CSECT to which this END record refers. 
Only if 6-8 present 

17 - 22 Symbolic label supplied to the assembler if this label was not 
defined within the assembly 

29 - 32 CSECT length (if not specified in last SD or PC) 

73 - 80 Not used 
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C 


The REP Record 


1 


iA. -= 
ia = 


Columns 


16 


70 


72 
80 


Hex 02; identifies a loader record. 
REP record 

Blank 
Assembled hex address of the first byte to be replaced. 
Right justified with leading zeros. 

(Note that there is no check to determine if the 

the assembled address is actually within this CSECT) 
Blank 
ESID hex number of the CSECT (SD) containing the text. 
Right justified with leading zeros. 
From 1 to 11 4-digit hex fields separated by commas. Each 
field takes two bytes. A blank shows end of information. 
Blank 
May be used for program identification 


Object Member Record Format 


In a sublibrary, an object module has only records of 80 bytes. 
These records contain either one and only one linkage editor state- 
ment or one of the five possible types of module record types (ESD, 
TXT, RLD, REP, or END). 


When job control or a language translator writes them on SYSLNK it 
adds to them two bytes of control information, a blocking factor and 
the record length of 80 bytes, and possibly blocks them to a block 
length of 322 bytes. 


Figure 12 shows the two possible record formats on SYSLNK. 


RR RI ac a | 


|<--82 Bytes--->| 


Format 1 |B1|B2| 80 Bytes| 
SS eS ee ee | 


Format 2 |B1|B2| 80 Bytes| 80 Bytes| 80 Bytes| 80 Bytes| 
Se a a a a 


B1(1 byte) - Blocking factor (either 1 or 4) 
B2(1 byte) -— Record Length = 80 


—_—_—— a ae a er ee eee a Se ee RR eee 


Figure 12. OBJ-Member Record Formats on SYSLNK 
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Figure 13 shows the format of a complete linkage editor input module 
on SYSLNK. The linkage editor statements may already be stored with 
the module in the sublibrary. 


|4|80| INCLUDE | INCLUDE | PHASE | ESD | 
|4|80|ESD | ESD | TXT | TXT | 
{H+} 
|4|80|TXT | TXT | TXT | REP | 
|4|80|REP | RLD | RLD | RLD | 
|4|80|RLD | END | | | 
| <a ee enn nn nn nnn nn nen nee en eee nee eee >| 
322 Bytes 


Figure 13. Example of a Module on SYSLNK 
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SYSLNK Control Interval Format 


Figure 14 shows a VSAM or FBA control interval (CI) with SYSLNK 
input records for the linkage editor. 


ee ee ee eee ee 
|record of 82 or | record of 82 or | ... | RDF1 | RDF2 | CIDF | 
| 322 bytes | 322 bytes | |3 bytes|3 bytes|4 bytes| 
Sk ret ae a el Rs LP ee er ene la ee Deas eee) (etek ee Lee a OEE) ORES rete 


| 

| 

| 

| 

| 

| 

| 

| CIDF: control interval definition field; 
| bytes 1,2: address of free space 
| bytes 3,4: length of free space 

| 
| 
| 
| 
| 
| 
| 
| 


RDF1: record definition field; 
byte 1: bit 1=0: only one 512 byte block in CI. 
bit 1=1: more than one 512 byte block in CI. 
bytes 2,3: length of block (512 bytes) 


RDF2: bytes 2,3: number of 512 byte blocks on this CI. 


a a ee | 


Figure 14. VSAM or FBA Format of SYSLNK Records 


Output Record Formats 
A phase is stored into the CATALOG sublibrary as a member of type 
PHASE. It contains executable code and, at the end of the phase, 
some RLD information, if the phase is relocatable. 

RLD Block Format 
The RLD items stored by CSECT IJBOTH in the RLD buffer are blocked 
to a length of 2020 bytes. If the RLD buffer is full, its content is 
written on workfile IJSYSO1. 


CSECT IJBRLD places the RLD items into the CATALOG sublibrary. The 
layout of an RLD block is shown in Figure 15. 
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Pile ce pe a ge ee ee ye ee 


| 
| Offset Length Content 

| 0 4 Number of RLD items in one block 
| 

| 


4 2016 RLD items 


—————————————————— 


Figure 15. Layout of an RLD Block 


LINKAGE EDITOR DATA AREAS 


Control Dictionary (CD) 


FUNCTION: The CD holds information on phases and modules for the 
address adjustment of the linkage editor. 


NAME: Control Dictionary 

LABEL OR IDENTIFIER: None 

LOCATION: Partition 

INITIALIZED BY: IJBINL 

POINTED TO BY: CDENT1 

USED BY: All CSECTs except IJBINL and INLPLEIT 

FORMAT OF CD ENTRIES: The CD has entries for ESD information, for 
modules, and for phases. The entries for phases and for ESD records 
are first built one by one in CSECT IJBLNK or stored temporarily in 
the current CD entries. During processing, the references to CD 
information are sometimes to fields of such "current entries" in the 
CSECTs instead of the CD entry field. In IJBLNK, a current phase 
entry is stored under the label CPHENT and a current ESD entry is 


stored under the label CESDENT. The layout of CD entries is the 
following: 
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OFFSETS TYPE LENGTH NAME DESCRIPTION 
O (0) STRUCTURE 0 CDENTRY 
0 (0) SIGNED 4 


ENTRY FOR SD,PC,CM,LD,LR,ER,WX RECORDS 


0 (0) CHARACTER 8 NAMED NAME OF ESD ITEM 
8 (8) HEX 1 ESDTYPD ESD TYPE 
9 (9) HEX 3 ASSORGD ASSEMBLED ORIGIN OR 
9 (9) HEX 3 LNGTHD LENGTH OF CM 
12 (C) SIGNED 4 RELFACD RELOCATION FACTOR 
12 (C) SIGNED 2 
14 (E) SIGNED 2 CSNUMD OR C/D # OR ESID # 
OF CSECT FOR LD/LR 
14 (E) SIGNED 2 PHNUMED OR PHASE # FOR ER/WX 
16 (10) SIGNED 2 PHNUMD PHASE # FOR SD/PC 
18 (12) HEX 1 SWITCHD DIVERSE SWITCHES 
19 (13) HEX 1 SWITCHD2 ADDITIONAL FLAG BYTE 
20 (14) SIGNED 2 SDXREFD XREF TO INPUT MODULE 
22 (16) SIGNED 2 
ENTRY FOR PHASE 
0 (0) CHARACTER 8 PHNAMED PHASE NAME 
8 (8) HEX 1 ESDTYPED ESD TYPE 
9 (9) HEX 5 RESERVED 
14 (E) SIGNED 2 RLDITEMD # OF RLD ITEMS 
16 (10) SIGNED 4 | TXTLEND TEXT LENGTH IN BYTES 
20 (14) SIGNED 4  RLDLRBD  LRBA FOR RLD ITEMS 
24 (18) SIGNED 4 ORPHRGD PHASE ORIGIN 
28 (1C) SIGNED 4 NXPHRGD NEXT PHASE ORIGIN 
32 (20) SIGNED 4 TRFRADD TRANSFER ADDRESS 
36 (24) SIGNED 4  LINKSTRD START OF PARTIT. 
40 (28) SIGNED 2 NUMBER OF EXTRA 
RLD BLOCKS 
42 (2A) CHARACTER 1 PHTYPED PHASE TYPE 
43 (2B) CHARACTER 1 PHTYP2D ADDITIONAL FLAGS 
i PHTYP2R ROOT PHASE 
fe ieee PHTYP2T FIRST PHASE PROCESSED 
ne emma PHDUMMY PHASE ENTRY WITHOUT TEXT 
44 (2C) SIGNED 4 DENTXREF XREF TO CORRESP. DICT.ENTRY 
ENTRY FOR MODULE NAME 
0 (0) CHARACTER 6 
6 (6) CHARACTER 2 LCDFLG RESERVED 
8 (8) HEX 1 LCDMTYP TYPE 
9 (9) HEX 1 LCDMVER VERSION 
10 (A) HEX 1 LCDMMOD MODIFICATION LEVEL 
11 (B) HEX 1 
12 (C) CHARACTER 8 LCDMNAM MODULE NAME 
20 (14) SIGNED 4 
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MASKS FOR ESDTYPD / ESDTYPED 


SD SECTION DEFINITION 
LD LABEL DEFINITION 
ER EXTERNAL REFERENCE 


ae LR LABEL REFERENCE 
na eee PC PRIVATE CODE 

ea | CM COMMON 

Ld PH PHASE ENTRY 
Leds WX WEAK EXTERNAL 


IC INCLUDED MODULE NAME 
DE SAVED DIRECTORY ENTRY 


MASK FOR SWITCHD 


eu 
odie 


UNASSG 
WXTRN THE ER IS WEAK EXTERNAL 


ee eee NOAUTOL NO AUTOLINK NECESSARY J 
1114) dL. ASSG MASK TO ASSIGN LD/LR 
MASKS FOR PHTYPED 
Teiab> siahene SELFRELO SELFRELOCATING PHASE 
re: RELPHASE RELOCATABLE PHASE 
itt ee ot he SVAELIG SVA ELIGIBLE 
EQU. x'OO' NOT RELOCATABLE 


Linkage Table 


FUNCTION: The language translator gives each ESD record a number 
called ESID number. The linkage editor gives it a CD number unique 
in the phase, because the same ESID number might occur several times 
coming from the different modules. A linkage table links the ESID 
number of each record from the language translator to the CD number | 
given to the record by the linkage editor. J 


NAME: Linkage Table 

LABEL OR IDENTIFIER: None 
LOCATION: Partition 

CHANGED BY: IJBESD and JJBCTL 
USED BY: All except INLPLEIT 


POINTED TO BY: LTMINE (= address of first item in linkage table 
minus 3) 


LAYOUT: A linkage table has up to 511 3-byte entries. Figure 16 , 
shows the format of an entry. Each object module has its own link- > 
age table. When an END record is processed, signalling the end of a 
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module, the table is reset to zeros. 


Control Dictionary Number ESD Type 


Pe ee eg EP ee ee a 
| 2 Bytes | 1 Byte | 
Sate eR ar ae Oe ee eee ee Pee a | 


Figure 16. Linkage Table Entry Format 


LIFO Stack (PERIDA) 


FUNCTION: The LIFO stack is built when an INCLUDE statement is proc- 
essed and used to 


1. obtain the address of the next record after the END statement 
2. determine the end of processing for an object module 
3. control the nesting of INCLUDE statements to give priorities. 


NAME: LIFO stack 

LABEL: PERIDA 

LOCATION: Top in IJBLNK 
INITIALIZED BY: IJBINL 
CHANGED BY: IJBCTL 
POINTED TO BY: LCSTBEG 


LAYOUT: 
ie i i i i rh, 


Label Offset Length Contents 
PERIDA 0 6 NOTE information for SYSLNK records 


| 
| 
| 
| PERISW 6 1 Status information: 

| X'01' SYSLNK input 

| X'02' Named submodular 

| X'08' Autolink active for current module 
| X'20' SYSLNK on FBA or VSAM managed space 
| X'80' Library input of type OBJ 
| 
| 
| 
| 
| 


PERILRC 7 1 Record count within block 

PERIRRN' 8 4 Relative record count 

PERIMNO C 2 Cross reference to module name for CSECTs 
being linked (CD offset) 

PERIRL E 1E NOTE information for relocatable modules 


Figure 17. Layout of the LIFO Area 
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LIFO-Head LIFO-Body in 
in IJBLNK Partition Space 


INCLUDE A: 


A says: INCLUDE B: BEN 


B says: INCLUDE C: First out 
Second out 


Figure 18. How the LIFO Stack Works. 


Communication Area LEITPL 


FUNCTION: Communication area between module (and CSECT) INLPLEIT and 
the CSECTs of module IJBLE1. 


NAME: LEITPL 
LABEL: LEITPL 
LOCATION: CSECT IJBLNK 


CHANGED BY: All CSECTs of module IJBLE1. 
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LAYOUT: 
OFFSETS TYPE LENGTH NAME DESCRIPTION 
0 (0) STRUCTURE 0 LEITPL 
0 (0) SIGNED 4 


LINKAGE EDITOR AND LIBRARIAN SERVICES INTERFACE 


Uk & 


(0) 
(4) 


(4) 
(5) 


(6) 


V-ADDRESS 


SIGNED 
HEX 
HEX 


4 


4 
1 
1 


OrrpRePrRrrPrP FEE SF KOK OO 


_— 
On 


LEITA 


LEITPL 
LEITFC 
LEITSW 
LE ITCHK 
LE ITMOLD 
LEITLINK 
LEITMSCN 
LEITMSPA 
LEITMSBY 
LEITMS1T 
LEITTMFND 
LEITSW1 
LEITNOCA 
LEITST1T 
LE ITEOM 
LEITSEVE 
LEITFULL 
LEITSDEL 
LEITGVIS 
LEI TCCON 
LEITSW2 
LEITDCAN 
LETTCARQ 
LEITSCON 
LEITSBUF 
LEITPBUF 
LE ITCOMM 
LE ITPNAM 
LE ITMARK 
LEITOFFS 
LEITTXT 
LEITTXTL 
LEITSTOW 


LEITRC 


LEITEC 
LEITVIOO 
LEITDTF 
LEITIO 
LEITARG 


"V(INLPLEIT)" ENTRY ADDR 
TO LE INTERFACE MODULE 
LE INTERFACE PARM LIST 
FUNCTION CODE 

SWITCHES 

CHECK ON RECORD REQUEST 
CONNECT USING OLD MACB 
LINK OPTION 

RUN UNDER MSHP CNTL 
PHASE UNDER MSHP CNTL 
MSHP BYPASS REQUEST 

1TH TIME MSHP 

PHASE ALREADY IN LIBRARY 


NO CATALOG SUBLIB GIVEN 
1ST TIME STOW 

END OF OBJ MODULE 

SEVERE ERROR OCCURED 
LIBRARY FULL 

FORCE STOW DELETE 

LAMB AVAILABLE FOR GETVIS 
CATALOG LIBRARY CONNECTED 


DELAYED CANCEL FORCED 
CANCEL REQUEST PENDING 
A SEARCH SUBLIBRARY CONNECTED 
SBUF DESCRIPTOR 

PBUF DESCRIPTOR 
COMMUN. AREA PTR 

PHASE NAME 

HI WATER MARK 

OFFSET FOR PUT 

ADDR. OF TEXT 

LENGTH OF TEXT 

ADDR OF STOW LIST 


RETURN CODE 


ERROR CODE 

PHASE START ADDRESS 

ADDR. OF LIST DTF 

ADDR. OF DTF I/O AREA 
LENGTH IS MULTIPLE OF 
DIR.ENTRY FOR STOW CD FIELDS 
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FUNCTION CODES IN LEITFC J 


re | OPENCAT 
Sele Ls NEWMEM 
well DISCMEM 
on eee DISCLIB 
om ee PUTREC 
i Ea GETREC 
-111 STOW 
baer FIND 
Died NOTE 
Leds POINT 
1.11 UPDTE 
a ee OPENOBJ 
lil. FINISH 
ERROR CODES IN LEITEC J 
teed: Lake NOCATSL NO CATALOG SUBLIB 
Sredian sige VIOEX VIO EXHAUSTED 
pwd teres MSHPCNPA PHASE CANNOT BE REPLACED 
a eee LIBFULL LIBRARY IS FULL 
LIBRARIAN DATA AREAS USED BY THE LINKAGE EDITOR J 


Stow Table 
FUNCTION: In this table the directory information for all phases 


produced during a linkage editor run is collected for the sublibrary 
directory. 


NAME: Stow Table J 
LABEL: None 

POINTED TO BY: LIMINE in IJBLNK 

INITIALIZED BY: IJBCAT 


CHANGED BY: IJBCAT 


LAYOUT: See VSE/Advanced Functions Diagnosis Reference: Librarian 
LY33-9111, data area INLCDENT. 
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C 


Buffers for Librarian Services 


FUNCTION: The linkage editor provides these buffers for the librar- 
ian services it requests: 

The S-buffer is a shared buffer for library management of the CATA- 
LOG sublibrary. The P-buffers are used for member 1/0, one to put 
phases into the CATALOG sublibrary and one to read input (modules or 
phases) from OBJ-search chain sublibraries. 

NAMES: S-Buffer and P-Buffers 

LABELS: None 

POINTED TO BY: SHARBUF, PHAPBUF, OBJPBUF in IJBLNK 

LOCATION: Partition of linkage editor 

ALLOCATED BY: IJBINL 

FORMATTED BY: Librarian 


CHANGED BY: Librarian 


LAYOUT: See VSE/Advanced Functions Diagnosis Reference: Librarian 
LY33-9111, data areas INLCBUCB and INLCBHDR. 
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C DIAGNOSTICS 


LINKAGE EDITOR LISTING AND MAP 


The linkage editor program lists for each execution the errors 
encountered and actions taken. This listing is followed by a link- 
age editor map prepared by CSECT IJBMAP. 

For a detailed description of the linkage editor listing and map see 


VSE/Advanced Functions: Service Aids SC33-6195. 
( The linkage editor map has the following columns: 


Phase name 

Transfer address 

Start and end of the virtual storage location 

For each CSECT of the phase: 

: labels in ascending order 

load address 

relocation factor 

offset of CSECT in the partition where link-edited 
offset of CSECT in phase 

name of object module from which the CSECT was taken (or 
SYSLNK) 


fF Wh 


Figure 19 shows an example of a linkage editor map. 
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- 
| 


PARTIT... 


PHASE 


XFR-AD LOCORE HICORE 


| ASSEMBLY 03C282 03A078 03CC40 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


ASSETA 


ASSECA 


etc. 


O3B8FO O3B8E8 03C388 


O3BF88 O3BF80 O3F16F 


CSECT/ 
ENTRY 


IPKAJO000 
IPKAA002 
IPKAAOOO 
*TPKAA5O1 
*TPKAA502 
*TPKAA503 
*TPKAA504 
*TPKAA5SO5 
*TPKAA506 
*TPKAA507 
*TPKAA508 
*TPKAA50O9 
*TPKAA511 
*TPKAA512 
+IPKAA101 
+IPKAA102 
+I PKAA103 
IPKABOO0O 
+IPKAB100 
+IPKAB101 
+IPKAB103 
+IPKAB102 
IPKAGOOO 
IJJCPD2 
*TJJCPD3 
IPKADOO0 
*TPKAD101 
IPKAD100 
IPKBAOOO 


IPKTAOO0O 
IJ2M0093 
IJJCPD1N 


IPKCAO01 
+IPKCA998 


LOADED 
AT 


03A078 
03A080 
03AA38 
03B228 
O3B1F8 
03B1C0 
03B1E8 
O3B1E8 
03B200 
03B1C8 
03B258 
03B258 
03B1E8 
03B210 
O3AAD0 
O3AB98 
03AC60 
03B378 
03B388 
03B520 
O3B58E 
O3B5C0 
O3B6B0 
O3B6B8 
O3B6B8 
O3B8E8 
O3B8F8 
03B900 
O3BF80 


O3B8E8 
03C010 
03C030 


O3BF80 
O3BF88 


RELOC. 
FACTOR 


03A078 


039600 
03AA38 


03B378 


O3B6B0 
O3B6B0 


O3B8E8 


O3B8E8 
O3BF80 


O3B8E8 
O3B8E8 
O3B8E8 


O3BF80 


OFFSET 
000000 


000008 
0009CO 


001630 


001638 
001640 


001870 


001888 
001F08 


001870 
001F98 
OO1FB8 


001F08 


A + in front of the label indicates a referenced entry point; 


an * shows an unreferenced label. 


Figure 19. Example of a Linkage Editor Map Printout 
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C 


INTERFACES 


All librarian and supervisor services for retrieval of linkage edi- 
tor library input and for storage of linkage editor library output 
are requested via CSECT INLPLEIT. This CSECT uses librarian and 
supervisor macros and interface control blocks. These are all listed 
in the operation description of INLPLEIT. 


In the partition, buffers are provided for librarian services. They 
are discussed as "Buffers for Librarian Services" in the Chapter 


"Data Areas". 


The stow table of the librarian is used by CSECT IJBCAT. 


CROSS REFERENCES 


Label-to-CSECT Cross Reference 


The following labels are those which appear in the Sequence of Oper- 
ation description in this manual. 


The CSECT names are shortened where they begin by IJB to show only 
the last characters. 
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Label 
ABTERR 
ALNKOF 
ALNKPR 
CALCWA 
CANCL 
CDENT1 
CDSIZE 
CESDENT 
CNVHDX 
CONCLIB 
CONNECT 
CPHENT 
ELBCM 
ELBER 
ELBLD 
ELBSD 
ENDPRC 
ENTCRD 
ERROR 
ESDRET 
EXLOAD 
FINDM 
IJBLETR 
INCCRD 
INLNOOO 
INTER100 
LCF IND 
LCLOSE 
LCSTBEG 
LEITCALL 
LEITPL 
LNKNOT 
LNKPOINT 
LOGMSG 
LTESID 
LTMINE 
NOTCTL 
NOTEM 
NXTCARD 
OBJBUF 
OPCATAL 
OPENC 
OPENJ 
PHAPBUF 
PHCRD 
PHSPRC 
POINTM 
PRINT 
PRTLST 
RDEXEX 
RDNEXT 
READ 
READIN 


CSECT 
IJBLNK 
LNK 
LNK 
INL 
LNK 
LNK 
LNK 
LNK 
LNK 
INL 
INLPLEIT 
IJBLNK 


LNK 
INLPLEIT 
IJBFIN 

SCN 

INL 

INL 

FIN 

FIN 

LNK 

FIN 

LNK 

FIN 

FIN 

LNK 

LNK 

LNK 

LNK 
INLPLEIT 


INL 
INLPLEIT 
INLPLEIT 
IJBLNK 

SCN 

CTL 
INLPLEIT 
IJBLNK 

LNK 

LNK 

LNK 
INLPEIT 
IJBFIN 


Label 
REPPRC 
RLDCON 
RLDOR 
RLDPRC 
SCANCD 
SHARBUF 
SPACE1 
SRCHCD 
SRPCOD 
STOWML 
TESTCNT 
TSTUNR 
TXTPRC 
UPDATE 
WRITE 
WRLST 
WRTRFR 
XTPHGT 
XTPHNO 


Message 
2100 
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LNK 
LNK 


INLPLEIT 


IJBRLD 


INLPLEIT 
INLPLEIT 


IJBRLD 
CTL 
LNK 
LNK 


CSECT 

IJBOTH 
SCN 
LNK, 
SCN 
SCN 
SCN, 
OTH, 
SCN 
FIN, 
SCN, 
SCN 
CTL 
SCN 
CTL 
CTL 
CTL 
SCN 
SCN 
SCN 
INL 
INL 
ESD 
ESD 
ESD 
ESD 
ESD 


Message-to-CSECT Cross Reference 


(only the causing CSECT is listed 
here) 


SCN 
INL 
INL, SCN 


MAP 
LNK 


Message CSECT 
44 LNK 


ESD 
ESD 


CTL 
IJBSCN 


INLPLEIT 
PLEIT 


IJBLNK 
MAP 


Statement 


ACTION 


INCLUDE 


PHASE 
ENTRY 


Input Record 


ESD 


Phase 


SLNKEDT 


CSECT 
IJBINL 
IJBSCN 


IJBSCN, 
IJBSCN, 


CSECT 
IJBESD 
IJBOTH 
IJBOTH 
IJBOTH 
I JBOTH 


Phase-to-Module Cross 


Module 
IJBLE1 


Input-to-CSECT Cross Reference 


IJBCTL 
IJBCTL 


Reference 


INLPLEIT 


Diagnostics 
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INDEX 


A 


access control 12 

ADCON (address constant) 8 
assembled origin 11 
Autolink 10, 21 


Cc 


calculations, linkage editor 11 
catalog 2 

CATALOG sublibrary 1 

CD (CD) 38 

CD (control dictionary) 14 

CD entry 40 

CD number 8, 40 

CM (common) 6 

collating sequence 21 
combination of linkage editor 
jobs 2 

common (CM) 7 

common constants 15 

common storage /7 

control dictionary (CD) 14 

control dictionary (CD), storage 
of ESD records §8 

control flow 31 

CSECTs, function 15 


D 


dictionaries (ESD, RLD) 5 
dictionary, control 8, 14 
dictionary, external symbol 6 
dictionary, relocation list 8 


E 


END (end record type) 5 

entry format, linkage table 40 
entry in CD, last 14 

entry in linkage table 20 

entry in member index 1 

entry point to linkage editor 15 
entry types in ESD 6 


entry, label definition 6 

ER (external reference) 6 

error handling 21 

error messages 51 

error messages, 
nontermination 21 

ESD (external symbol 
dictionary) 5 

ESD entry types 6 

ESD records 8, 15 

ESID number 8, 40 

external reference (ER) 6 

external symbol dictionary 
(ESD) 6 

EXTRN 6 


F 


figure list ix 

flow of control 31 
flow of I/O 12 
function of CSECTs 15 


I/O flow 12 

IJSYSO1 workfile 37 
initialization for linkage 
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